:: explain -c180 -r
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
          author: (auto-adjust                         ) Someone
              \_: (setup.py:2                          ) Someone someone@example.com
    author_email: (auto-adjust                         ) someone@example.com
     classifiers: (explicit                            ) ["Programming Language :: Python"]
         contact: (src/My_cplx_nm_here/__init__.py:14  ) Someone
   contact_email: (src/My_cplx_nm_here/__init__.py:15  ) me@example.com
     description: (README:1                            ) My cplx-nm_here - Sample complex project
              \_: (src/My_cplx_nm_here/__init__.py:2   ) Short description of complex project
    download_url: (auto-fill                           ) https://example.com/complex/archive/1.2.3.tar.gz
              \_: (setup.py:4                          ) archive/{version}.tar.gz
    entry_points: (explicit                            ) {console_scripts: a=b}
              \_: (entry_points.ini                    ) [foo] [console_scripts] foo = My_cplx_nm_here.some_module:main_func bar = My_cplx_nm_here.some_module:bar
  extras_require: (explicit                            ) {bar: ["docutils"], baz: ["some", "long", "list-of", "requirements"], foo: ["long", "enough", "to-be", "abbreviated"]}
install_requires: (pinned.txt                          ) ["a", "b", "c", "d>1", "e==1", "f", "g", "h", "i==1"]
        keywords: (explicit                            ) ["some", "list", "of", "keywords", "here", "long", "enough", "to", "be", "abbreviated", "by", "the", "explain", "command"]
              \_: (setup.py:5                          ) ["setup", "docstring"]
              \_: (setup.py:13                         ) ["some", "list", "of", "keywords", "here", "long", "enough", "to", "be", "abbreviated", "by", "the", "explain", "command"]
              \_: (src/My_cplx_nm_here/__version__.py:6) ["complex", "version"]
              \_: (src/My_cplx_nm_here/__init__.py:7   ) ["src", "complex", "init"]
         license: (explicit                            ) foo
              \_: (auto-fill                           ) BSD
long_description: (README                              ) My cplx-nm_here - Sample complex project README is a regular txt file HISTORY here.Done with README.
      maintainer: (auto-adjust                         ) Someone
              \_: (src/My_cplx_nm_here/__version__.py:4) Someone me@example.com
              \_: (src/My_cplx_nm_here/__init__.py:11  ) Someone me2@example.com
maintainer_email: (auto-adjust                         ) me@example.com
            name: (setup.py:14                         ) My cplx-nm_here
     package_dir: (auto-fill                           ) {: src}
        packages: (auto-fill                           ) ["My_cplx_nm_here", "My_cplx_nm_here.submodule"]
  setup_requires: (explicit                            ) ["setupmeta"]
          title*: (setup.py:14                         ) My cplx-nm_here
             url: (setup.py:3                          ) https://example.com/complex
         version: (git                                 ) 1.2.3
              \_: (setup.py:6                          ) 1.0a1
              \_: (setup.py:12                         ) 1.0b1
              \_: (src/My_cplx_nm_here/__version__.py:3) 1.2.3
              \_: (src/My_cplx_nm_here/__init__.py:8   ) 1.3.0
      versioning: (explicit                            ) dev;.hooks/bump

:: explain -d
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
    # This reflects only auto-fill, doesn't look at explicit settings from your setup.py
    install_requires=[
        "a",     # from pinned.txt:2
        "b",     # from pinned.txt:3, abstracted by default
        "c",     # from pinned.txt:4, 'abstract' stated on line
        "d>1",   # from pinned.txt:5
        "e==1",  # from pinned.txt:9, in 'pinned' section
        "f",     # from pinned.txt:10, in 'pinned' section
        "g",     # from pinned.txt:11, 'abstract' stated on line
        "h",     # from pinned.txt:14, in 'abstract' section
        "i==1",  # from pinned.txt:15, 'pinned' stated on line
    ],

:: explain --expand
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
"""
Generated by https://pypi.org/project/setupmeta/
"""
from setuptools import setup
__version__ = "1.2.3"
setup(
    author="Someone",                                        # from setup.py:2
    author_email="someone@example.com",
    classifiers=["Programming Language :: Python"],
    contact="Someone",                                       # from src/My_cplx_nm_here/__init__.py:14
    contact_email="me@example.com",                          # from src/My_cplx_nm_here/__init__.py:15
    description="My cplx-nm_here - Sample complex project",  # from README:1
    download_url="https://example.com/complex/archive/%s.tar.gz" % __version__, # from setup.py:4
    entry_points={"console_scripts": "a=b"},
    extras_require={
        "bar": ["docutils"],
        "baz": ["some", "long", "list-of", "requirements"],
        "foo": ["long", "enough", "to-be", "abbreviated"]
    },
    install_requires=["a", "b", "c", "d>1", "e==1", "f", "g", "h", "i==1"], # from pinned.txt
    keywords=[
        "some",
        "list",
        "of",
        "keywords",
        "here",
        "long",
        "enough",
        "to",
        "be",
        "abbreviated",
        "by",
        "the",
        "explain",
        "command"
    ],
    license="foo",
    long_description=open("README").read(),                  # from README
    maintainer="Someone",                                    # from src/My_cplx_nm_here/__version__.py:4
    maintainer_email="me@example.com",
    name="My cplx-nm_here",                                  # from setup.py:14
    package_dir={"": "src"},
    packages=["My_cplx_nm_here", "My_cplx_nm_here.submodule"],
    url="https://example.com/complex",                       # from setup.py:3
    version=__version__,                                     # from git
    # versioning="dev;.hooks/bump",
)

:: check
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
[setupmeta] install_requires: 4 abstracted, 3 ignored, 5 untouched

:: entrypoints
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
a=b

:: version
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
1.2.3

:: version --bump patch
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
Not committing bump, use --commit to commit
Not pushing bump, use --push to push
Would update setup.py:6 with: version: 1.2.4
Would update setup.py:12 with: __version__ = "1.2.4"
Would update src/My_cplx_nm_here/__version__.py:3 with: __version__ = "1.2.4"  # Ignored due to setuptools_scm ref
Would update src/My_cplx_nm_here/__init__.py:8 with: __version__ = '1.2.4'
Would run: git add setup.py src/My_cplx_nm_here/__init__.py src/My_cplx_nm_here/__version__.py
Would run: git commit -m "Version 1.2.4"
Would run: git tag -a v1.2.4 -m "Version 1.2.4"
Would run: <target>/.hooks/bump "My cplx-nm_here" master 1.2.4

:: version --bump minor --push
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
Not committing bump, use --commit to commit
Would update setup.py:6 with: version: 1.3.0
Would update setup.py:12 with: __version__ = "1.3.0"
Would update src/My_cplx_nm_here/__version__.py:3 with: __version__ = "1.3.0"  # Ignored due to setuptools_scm ref
src/My_cplx_nm_here/__init__.py:8 already has the right version
Would run: git add setup.py src/My_cplx_nm_here/__version__.py
Would run: git commit -m "Version 1.3.0"
Would run: git push origin
Would run: git tag -a v1.3.0 -m "Version 1.3.0"
Would run: git push --tags origin
Would run: <target>/.hooks/bump "My cplx-nm_here" master 1.3.0

:: version --bump major
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
Not committing bump, use --commit to commit
Not pushing bump, use --push to push
Would update setup.py:6 with: version: 2.0.0
Would update setup.py:12 with: __version__ = "2.0.0"
Would update src/My_cplx_nm_here/__version__.py:3 with: __version__ = "2.0.0"  # Ignored due to setuptools_scm ref
Would update src/My_cplx_nm_here/__init__.py:8 with: __version__ = '2.0.0'
Would run: git add setup.py src/My_cplx_nm_here/__init__.py src/My_cplx_nm_here/__version__.py
Would run: git commit -m "Version 2.0.0"
Would run: git tag -a v2.0.0 -m "Version 2.0.0"
Would run: <target>/.hooks/bump "My cplx-nm_here" master 2.0.0

:: version --bump minor --commit
WARNING: In setup.py:6 version should be '1.2.3', not '1.0a1'
Not pushing bump, use --push to push
src/My_cplx_nm_here/__init__.py:8 already has the right version
Running: git add setup.py src/My_cplx_nm_here/__version__.py
Running: git commit -m "Version 1.3.0"
Running: git tag -a v1.3.0 -m "Version 1.3.0"
Running: <target>/.hooks/bump "My cplx-nm_here" master 1.3.0

:: version --bump major --commit --push
Running: git add setup.py src/My_cplx_nm_here/__init__.py src/My_cplx_nm_here/__version__.py
Running: git commit -m "Version 2.0.0"
Running: git push origin
Running: git tag -a v2.0.0 -m "Version 2.0.0"
Running: git push --tags origin
Running: <target>/.hooks/bump "My cplx-nm_here" master 2.0.0

:: version
2.0.0

:: explain -c180
          author: (auto-adjust                         ) Someone
              \_: (setup.py:2                          ) Someone someone@example.com
    author_email: (auto-adjust                         ) someone@example.com
     classifiers: (explicit                            ) ["Programming Language :: Python"]
         contact: (src/My_cplx_nm_here/__init__.py:14  ) Someone
   contact_email: (src/My_cplx_nm_here/__init__.py:15  ) me@example.com
     description: (README:1                            ) My cplx-nm_here - Sample complex project
              \_: (src/My_cplx_nm_here/__init__.py:2   ) Short description of complex project
    download_url: (auto-fill                           ) https://example.com/complex/archive/2.0.0.tar.gz
              \_: (setup.py:4                          ) archive/{version}.tar.gz
    entry_points: (explicit                            ) {console_scripts: a=b}
              \_: (entry_points.ini                    ) [foo] [console_scripts] foo = My_cplx_nm_here.some_module:main_func bar = My_cplx_nm_here.some_module:bar
  extras_require: (explicit                            ) {bar: ["docutils"], baz: ["some", "long", "list-of", "requirements"], foo: ["long", "enough", "to-be", "abbreviated"]}
install_requires: (pinned.txt                          ) ["a", "b", "c", "d>1", "e==1", "f", "g", "h", "i==1"]
        keywords: (explicit                            ) ["some", "list", "of", "keywords", "here", "long", "enough", "to", "be", "abbreviated", "by", "the", "explain", "command"]
              \_: (setup.py:5                          ) ["setup", "docstring"]
              \_: (setup.py:13                         ) ["some", "list", "of", "keywords", "here", "long", "enough", "to", "be", "abbreviated", "by", "the", "explain", "command"]
              \_: (src/My_cplx_nm_here/__version__.py:6) ["complex", "version"]
              \_: (src/My_cplx_nm_here/__init__.py:7   ) ["src", "complex", "init"]
         license: (explicit                            ) foo
              \_: (auto-fill                           ) BSD
long_description: (README                              ) My cplx-nm_here - Sample complex project README is a regular txt file HISTORY here.Done with README.
      maintainer: (auto-adjust                         ) Someone
              \_: (src/My_cplx_nm_here/__version__.py:4) Someone me@example.com
              \_: (src/My_cplx_nm_here/__init__.py:11  ) Someone me2@example.com
maintainer_email: (auto-adjust                         ) me@example.com
            name: (setup.py:14                         ) My cplx-nm_here
     package_dir: (auto-fill                           ) {: src}
        packages: (auto-fill                           ) ["My_cplx_nm_here", "My_cplx_nm_here.submodule"]
  setup_requires: (explicit                            ) ["setupmeta"]
          title*: (setup.py:14                         ) My cplx-nm_here
             url: (setup.py:3                          ) https://example.com/complex
         version: (git                                 ) 2.0.0
              \_: (setup.py:6                          ) 2.0.0
              \_: (setup.py:12                         ) 2.0.0
              \_: (src/My_cplx_nm_here/__version__.py:3) 2.0.0
              \_: (src/My_cplx_nm_here/__init__.py:8   ) 2.0.0
      versioning: (explicit                            ) dev;.hooks/bump

:: --name
My cplx-nm_here
